Welcome!
This sample signature template file contains all default replacement variables defined in '.\config\default replacement variables.ps1'.
This file also contains examples for more advanced features of Set-OutlookSignatures:
· User photos stored in your on-prem Active Directory or in Entra ID
· Custom images
· Images formatted as shapes and inline shapes
· Conditional deletion of images
· Avoid empty lines in signatures
You may also notice that all hyperlinks and images have additional description for maximum barrier-free accessibility with screen readers and comparable tools. To create these descriptions, use Word ScreenTips or the HTML title attribute for hyperlinks, and alt text for images. Replacement variables are supported. All links and images in sample templates in the sample templates are accessible barrier-free.
All these topics are described in the online documentation at https://set-outlooksignatures.com. Please read the documentation carefully before opening a new issue at GitHub.
As this signature template file is not generated automatically, it may not be up to date. Should you find an error, please create a new issue at https://github.com/Set-OutlookSignatures/Set-OutlookSignatures/issues.
If you have created custom replacement variables, these variables are not automatically included here.
Default replacement variables
Default replacement variables are available for the current user, the current mailbox, and their managers.
The following table shows you the default replacement variables you can use in your templates. The columns define the namespace, the rows the attribute, and the crossing of both shows the actual value of the variable.
Let’s take the the upper left value: The namespace is "$CurrentUser", the variable is "GivenName$", which gives the replacement variable name "CurrentUserGivenName" – you just have to add a starting and a trailing $ character in your template. See '.\docs\sample templates' for examples.
|
|
Currently
logged-on user |
Manager of
currently logged-on user |
Current mailbox |
Manager of
current mailbox |
|
…GivenName$ |
Bobby |
Alex |
Bobby |
Alex |
|
…Surname$ |
Busy |
Alien |
Busy |
Alien |
|
…NameWithHonorifics$ |
Bobby Busy |
Alex Alien |
Bobby Busy |
Alex Alien |
|
…Company$ |
Galactic Experiences |
Galactic Experiences |
Galactic Experiences |
Galactic Experiences |
|
…Department$ |
Office of the Executive Board |
Executive Board |
Office of the Executive Board |
Executive Board |
|
…Title$ |
Secretary to the CEO |
Chief Executive Officer |
Secretary to the CEO |
Chief Executive Officer |
|
…Office$ |
7409 |
7407 |
7409 |
7407 |
|
…StreetAddress$ |
Kaisereb. Str. 206b/3/2 |
Kaisereb. Str. 206b/3/2 |
Kaisereb. Str. 206b/3/2 |
Kaisereb. Str. 206b/3/2 |
|
…Postalcode$ |
1110 |
1110 |
1110 |
1110 |
|
…Location$ |
Wien |
Wien |
Wien |
Wien |
|
…State$ |
|
|
|
|
|
…Country$ |
Austria |
Austria |
Austria |
Austria |
|
..Telephone-E164$ ..Telephone-International$ ..Telephone-National$ ..Telephone-RFC3966$ |
+43 800 1234,212 +438001234 +43 800 1234 ext. 212 0800 1234 ext. 212 tel:+43-800-1234;ext=212 |
+43 800 1234,101 +438001234 +43 800 1234 ext. 101 0800 1234 ext. 101 tel:+43-800-1234;ext=101 |
+43 800 1234,212 +438001234 +43 800 1234 ext. 212 0800 1234 ext. 212 tel:+43-800-1234;ext=212 |
+43 800 1234,101 +438001234 +43 800 1234 ext. 101 0800 1234 ext. 101 tel:+43-800-1234;ext=101 |
|
…Fax$
..Fax-E164$ ..Fax-International$ ..Fax-National$ ..Fax-RFC3966$ |
+43 800 1234,9212 +438001234 +43 800 1234 ext. 9212 0800 1234 ext. 9212 tel:+43-800-1234;ext=9212 |
+43 800 1234,9101 +438001234 +43 800 1234 ext. 9101 0800 1234 ext. 9101 tel:+43-800-1234;ext=9101 |
+43 800 1234,9212 +438001234 +43 800 1234 ext. 9212 0800 1234 ext. 9212 tel:+43-800-1234;ext=9212 |
+43 800 1234,9101 +438001234 +43 800 1234 ext. 9101 0800 1234 ext. 9101 tel:+43-800-1234;ext=9101 |
|
…Fax$ |
+43 800 1234,9212 |
+43 800 1234,9101 |
+43 800 1234,9212 |
+43 800 1234,9101 |
|
…Mobile$
..Mobile-E164$ ..Mobile-International$ ..Mobile-National$ ..Mobile-RFC3966$ |
+43 800 9876543 +438009876543 +43 800 9876543 0800 9876543 tel:+43-800-9876543 |
+43 800 12345678 +4380012345678 +43 800 12345678 0800 12345678 tel:+43-800-12345678 |
+43 800 9876543 +438009876543 +43 800 9876543 0800 9876543 tel:+43-800-9876543 |
+43 800 12345678 +4380012345678 +43 800 12345678 0800 12345678 tel:+43-800-12345678 |
|
…Mail$ |
bobby.busy@galactic.experiences |
alex.alien@galactic.experiences |
bobby.busy@galactic.experiences |
alex.alien@galactic.experiences |
|
…MailNickname$ |
bobby.busy |
alex.alien |
bobby.busy |
alex.alien |
|
…DisplayName$ |
Bobby Busy |
Alex Alien |
Bobby Busy |
Alex Alien |
|
…ExtAttr1$ |
Sekretär:in des:der Vorstandsvorsitzenden |
Vorstandsvorsitzende:r |
Sekretär:in des:der Vorstandsvorsitzenden |
Vorstandsvorsitzende:r |
|
…ExtAttr2$ |
Büro des Vorstands |
Vorstand |
Büro des Vorstands |
Vorstand |
|
…ExtAttr3$ |
Mr. |
Ms. |
Mr. |
Ms. |
|
…ExtAttr4$ |
|
|
|
|
|
…ExtAttr5$ |
|
|
|
|
|
…ExtAttr6$ |
|
|
|
|
|
…ExtAttr7$ |
|
|
|
|
|
…ExtAttr8$ |
|
|
|
|
|
…ExtAttr9$ |
|
|
|
|
|
…ExtAttr10$ |
|
|
|
|
|
…ExtAttr11$ |
|
|
|
|
|
…ExtAttr12$ |
|
|
|
|
|
…ExtAttr13$ |
|
|
|
|
|
…ExtAttr14$ |
|
|
|
|
|
…ExtAttr15$ |
|
|
|
|
|
…PostalAddress$ |
Bobby Busy |
Alex Alien |
Bobby Busy |
Alex Alien |
|
…Photo$, |
See ‘User photos’ below |
See ‘User photos’ below |
See ‘User photos’ below |
See section ‘User photos’ below |
|
…CustomImage[1..10]$, |
See ‘Custom images’ below |
See section ‘Custom images’ below |
See section ‘Custom images’ below |
See section ‘Custom images’ below |
|
…AnUndefinedVariable$ |
$CurrentUserAnUndefinedVariable$ |
$CurrentUserManagerAnUndefinedVariable$ |
$CurrentMailboxAnUndefinedVariable$ |
$CurrentMailboxAnUndefinedVariable$ |
To simplify signature design with limited space, shorter versions of replacement variables are available:
· CurrentUser
-> U
Example: '$CurrentUserVariableX$' is also available as '$UVariableX$'
· CurrentUserManager
-> UM
Example: '$CurrentUserManagerVariableX$' is also available as '$UMVariableX$'
· CurrentMailbox
-> M
Example: '$CurrentMailboxVariableX$' is also available as '$MVariableX$'
· CurrentMailboxManager
-> MM
Example: '$CurrentMailboxManagerVariableX$' is also available as '$MMVariableX$'
User photos
User photos from Active Directory/Entra ID are automatically available via replacement variables.
|
Scope |
$Current[…]Photo$
|
$Current[…]PhotoDeleteEmpty$ |
$Current[…]Photo$ with some fancy formatting
|
|
|
The pictures in this column are inserted in Word with embedding and linking, the alternate text is set to '$Current[…]Photo$'.
If the thumbailPhoto attribute has data, the sample picture is replaced. If thumbnailPhoto does not have data, the sample picture is shown. |
The pictures in this column are inserted in Word with embedding and linking, the alternate text is set to '$Current[…]PhotoDeleteEmpty$'.
If the thumbailPhoto attribute has data, the sample picture is replaced. If thumbnailPhoto does not have data, the sample picture is deleted. |
This column is only relevant when using DOCX templates, as HTM templates do not support Word image effects.
The pictures in this column are inserted with embedding and linking, the alternate text is set to '$Current[…]Photo$'. Additionally, some Word image effects are applied.
If the thumbnailPhoto attribute has data, the sample picture is replaced. If thumbnailPhoto does not have data, the sample picture is shown. |
|
Currently logged-on user |
$CurrentUserPhoto$
|
$CurrentUserPhotoDeleteEmpty$
|
$CurrentUserPhoto$
|
|
Manager of currently logged-on user |
$CurrentUserManagerPhoto$
|
$CurrentUserManagerPhotoDeleteEmpty$
|
$CurrentUserManagerPhoto$
|
|
Current mailbox |
$CurrentMailboxPhoto$
|
$CurrentMailboxPhotoDeleteEmpty$
|
$CurrentMailboxPhoto$
|
|
Manager of current mailbox |
$CurrentMailboxManagerPhoto$
|
$CurrentMailboxManagerPhotoDeleteEmpty$
|
$CurrentMailboxManagerPhoto$
|
When using DOCX templates, it also works fine with inline (!) shapes. In this case, no linking and embedding is required, just add the replacement variable to the alternate text. Set-OutlookSignatures will then fill the inline shape with the account picture. Just don’t forget to format the shape as “inline with text”.
As you have seen the principle before, the following table only shows the account picture of the currently logged-on user.
|
Scope |
$Current[…]Photo$
|
$Current[…]PhotoDeleteEmpty$ |
$Current[…]Photo$ with some fancy formatting
|
|
|
This column is only relevant when using DOCX templates, as HTM templates do not support Word inline shapes.
If the thumbailPhoto attribute has data, the sample picture is replaced. If thumbnailPhoto does not have data, the sample picture is shown. |
This column is only relevant when using DOCX templates, as HTM templates do not support Word inline shapes.
If the thumbailPhoto attribute has data, the sample picture is replaced. If thumbnailPhoto does not have data, the sample picture is deleted. |
This column is only relevant when using DOCX templates, as HTM templates do not support Word image effects.
If the thumbnailPhoto attribute has data, the sample picture is replaced. If thumbnailPhoto does not have data, the sample picture is shown. |
|
Currently logged-on user |
$CurrentUserPhoto$
|
$CurrentUserPhotoDeleteEmpty$
|
$CurrentUserPhoto$
|
Custom images
Fore each replacement variable namespace, there are 10 variables you can fill with custom image data:
· $CurrentUserCustomImage[1..10]$, $CurrentUserCustomImage[1..10]DeleteEmpty$
· $CurrentUserManagerCustomImage[1..10]$, $CurrentUserManagerCustomImage[1..10]DeleteEmpty$
· $CurrentMailboxCustomImage[1..10]$, $CurrentMailboxCustomImage[1..10]DeleteEmpty$
· $CurrentMailboxManagerCustomImage[1..10]$, $CurrentMailboxManagerCustomImage[1..10]DeleteEmpty$
Per default, all custom image variables are empty, but CustomImage1 is a QR code containing a vCard.
|
Scope |
$Current[…]CustomImage1$
|
$Current[…]CustomImage1DeleteEmpty$ |
|
|
The pictures in this column are inserted with embedding and linking, the alternate text is set to '$Current[…]CustomImage1$'.
If the replacement variable has data, the sample picture is replaced. If the replacement variable does not have data, the sample picture is shown. |
The pictures in this column are inserted with embedding and linking, the alternate text is set to '$Current[…]CustomImage1DeleteEmpty$'.
If the replacement variable has data, the sample picture is replaced. If the replacement variable does not have data, the sample picture is deleted. |
|
Currently logged-on user |
$CurrentUserCustomImage1$
|
$CurrentUserCustomImage1DeleteEmpty$
|
|
Manager of currently logged-on user |
$CurrentUserManagerCustomImage1$
|
$CurrentUserManagerCustomImage1DeleteEmpty$
|
|
Current mailbox |
$CurrentMailboxCustomImage1$
|
$CurrentMailboxCustomImage1DeleteEmpty$
|
|
Manager of current mailbox |
$CurrentMailboxManagerCustomImage1$
|
$CurrentMailboxManagerCustomImage1DeleteEmpty$
|
Conditional deletion of images
Below this line, the template file contains four rectangles, each with a different color: Blue, red, yellow, and green.
In the resulting signature file, not all these rectangles may appear:
· The blue rectangle is always shown.
· The red rectangle is only shown when the CurrentUserTelephone replacement variable has a value.
· The yellow rectangle is only shown when the CurrentMailboxExtAttr10 replacement variable has a value.
· The green rectangle is only shown when the CurrentMailboxManagerMail replacement variable has a value.
You can use this, for example, to:
· Only show images with links to social networks when the corresponding link is available in an Active Directory/Entra ID/Graph attribute.
· Show or hide pictures based on the group membership of the current mailbox (only use one template file instead of many only differing by the images used – see the chapter 'Delete images when attribute is empty, variable content based on group membership' in the FAQ for details).
Avoid empty lines in signatures
See the chapter 'How to avoid blank lines when replacement variables return an empty string?' in the FAQ for configuration details.
Shapes and inline shapes
The following sample text contains two images which are shapes and not inline shapes: A person placeholder image behind the sample text, and a person placeholder image in front of the sample text.
The layout of the final signature file may be unexpected as only inline shapes are handled as if they are part of the text. In the concrete example, most browsers will correctly render the resulting HTM signature file, displaying the person placeholder images behind and in front of the text, but Outlook may: Display both person placeholder images at the beginning of the paragraph and treat them as inline shapes, or not display them at all, or show an error.
Set-OutlookSignatures
shows a warning when non-inline shapes are found in a template.
Lorem ipsum dolor sit amet, consectetur adipisici elit, sed eiusmod tempor incidunt ut labore et dolore magna aliqua. Ut enim ad minim veniam, quis nostrud exercitation ullamco laboris nisi ut aliquid ex ea commodi consequat. Quis aute iure reprehenderit in voluptate velit esse cillum dolore eu fugiat nulla pariatur. Excepteur sint obcaecat cupiditat non proident, sunt in culpa qui officia deserunt mollit anim id est laborum.
Duis autem vel eum iriure dolor in hendrerit in vulputate velit esse molestie consequat, vel illum dolore eu feugiat nulla facilisis at vero eros et accumsan et iusto odio dignissim qui blandit praesent luptatum zzril delenit augue duis dolore te feugait nulla facilisi. Lorem ipsum dolor sit amet, consectetuer adipiscing elit, sed diam nonummy nibh euismod tincidunt ut laoreet dolore magna aliquam erat volutpat.
Ut wisi enim ad minim veniam, quis nostrud exerci tation ullamcorper suscipit lobortis nisl ut aliquip ex ea commodo consequat. Duis autem vel eum iriure dolor in hendrerit in vulputate velit esse molestie consequat, vel illum dolore eu feugiat nulla facilisis at vero eros et accumsan et iusto odio dignissim qui blandit praesent luptatum zzril delenit augue duis dolore te feugait nulla facilisi.